package com.ruoyi.student.service;

import org.springframework.web.multipart.MultipartFile;
import java.util.Map;

/**
 * 学生照片服务接口
 * 处理照片上传和学生信息匹配逻辑
 */
public interface IStudentPhotoService {

    /**
     * 上传学生照片
     * @param files 照片文件数组
     * @param uploadPath 上传路径
     * @return 成功上传的文件数量
     * @throws Exception 异常
     */
    int uploadPhotos(MultipartFile[] files, String uploadPath) throws Exception;

    /**
     * 匹配并更新学生照片
     * @param photoPath 照片存放路径
     * @return 匹配结果，包含总文件数和匹配成功数
     * @throws Exception 异常
     */
    Map<String, Integer> matchAndUpdatePhotos(String photoPath) throws Exception;
}
